home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / tt / djcdum21 / tt_dump.txt < prev    next >
Encoding:
Text File  |  1996-09-18  |  13.3 KB  |  351 lines

  1. DJCDUMP V2.1
  2. ************
  3.  
  4.      HP DeskJet 500C Screen Dump ACC
  5.      ===============================
  6.  
  7.    Developed using Lattice C v.5.52
  8.    by Dany Roth 15.08.1992 
  9.    Wannerstrasse 24/27
  10.    CH-8045 Zurich
  11.    Switzerland
  12.    Tel: ++41-1-461-6552 (41 for Switzerland)
  13.  
  14. For use with HP DeskJet 500C printer
  15. the archive file should contain the following files:
  16. 1) TT_DUMP.ACC    Accessory for the root directory of your boot disk
  17. 2) DJ_ON.CPX      CPX module for XCONTROL.ACC to reinit HP-DJ printers
  18. 3) DJ_ON.TOS      TOS PRG to reinit the parallel port for HP printers
  19. 4) TT_PATCH.PRG   Patch program for setting the hot key combination
  20. 5) TT_DUMP.ME     READ.ME file (documentation)
  21. 6) SNAPXIMG.ACC   A snap acc for saving the screen as GEM XIMG
  22.  
  23. *****************************************************************
  24. * New V2.1                                                      *
  25. * 1) Monochrome printing improved. The dither is more accurate  *
  26. * 2) Save IMG option, for saving any screen or top window or    *
  27. *    partial screen (mono/col) as a B/W GEM IMG                 *
  28. * 3) A forgotten feature, in monochrome printing it is possible *
  29. *    to print on any Desk-Jet or HP or compatible laser printers*
  30. *****************************************************************
  31.  
  32.  
  33. *****************************************************************
  34. * New V2.0                                                      *
  35. * 1) Capability to activate the ACC using HOT KEYS              *
  36. * 2) Top-Window prints contents of the active top-window        *
  37. * 3) Choice between colour-Monochrome printing                  *
  38. * 4) Portrait and Landscape printing in colour and monochrome   *
  39. * 5) More stable and more compatible                            *
  40. * 6) A new PATCH program to set the Hot-Key combination         *
  41. * 7) A new CPX module to turn DeskJet printer on.               *
  42. *****************************************************************
  43.  
  44. *****************************************************************
  45. * NEW v1.1                                                      *
  46. * There is a small problem in the VDI which causes a wrong      *
  47. * return value from the function v_get_pixel(...pel,index)      *
  48. * it returns an index of 255 for the pel value 15 instead of    *
  49. * index 1 which corresponds to the color black. This situation  *
  50. * happens only in TT MID resolution. I didn't find this problem *
  51. * cause I use NVDI v2.01 which probably corrects this problem   *
  52. * internaly. So I checked it one day without NVDI installed and *
  53. * then it happend. On tests on other TTs it proved to be the    *
  54. * same.                                                         *
  55. * So in this version this problem has been fixed. In addition   *
  56. * several other problems were eliminated (I hope for ever) and  *
  57. * the ACC is shorter with 1 Kb to 10.8 Kb and should work       *
  58. * faster.                                                       *
  59. *****************************************************************
  60.  
  61.  
  62. *****************************************************************
  63. * NEW v1.03                                                     *
  64. * The time needed to produce a A4 copy of TT 640x480 resolution *
  65. * was shortend to ~5-6 min. instead of ~25 min before           *
  66. * One can press q or ESC to break the printout in the middle.   *
  67. *                                                               *
  68. * If you use TTFRACT3.PRG set first the parameters in TT_DUMP   *
  69. * and then leave it using CANCEL. When you will use TT_DUMP     *
  70. * in the menu of TTFRACT3.PRG it will start directly to print   *
  71. * using the preset parameters in the ACC.                       *
  72. *****************************************************************
  73.  
  74. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  75. !! IMPORTANT:                                               !!
  76. !! Please rename the ACC to TT_DUMP.ACC                     !!
  77. !! in order that programs (as TTFRACT3.PRG) will be able to !!
  78. !! find the ACC and communicate with it.                    !!
  79. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  80.  
  81. Also in this package is a small program called DJ_ON.TOS
  82. which will reinitialize the parallel port.
  83.  
  84. As alternative one can use the DJ_ON.CPX which is a XCONTROL CPX
  85. module which enables you to reset the parallel port by a click
  86. of the mouse.
  87.  
  88.  
  89. The problem HP DeskJet serie has is that, if you start your
  90. computer before of your printer the printer won't be able to
  91. communicate with the computer.
  92. You have 2 possibilities
  93. 1) Always start your printer first and only then the computer.
  94. 2) Use the DJ_ON.TOS by double clicking on it from the DeskTop.
  95.  
  96. STORY:
  97. Since the appearance of the ATARI-TT one
  98. could notice a lack in screen dump support
  99. for the new TT resolutions.
  100. After waiting for a year now I have put away
  101. my hopes that someone somewhere will do the 
  102. job for me!
  103. No public domain or sharware or ATARI showed
  104. Interest/Knowledge/.... So what was left
  105. except trying myself?
  106.  
  107. First I have released the TT_DUMP 1&2
  108. which allows you to produce hard copies
  109. on LaserJet II (and compatibles), NEC P6
  110. and Epson FX series.
  111.  
  112. Since the appearance of the HP DESKJET 500C
  113. a new dimension of color printing started.
  114. This printer is capable of printing using
  115. 3 color combinations 
  116. 1) Cyan Magenta Yellow
  117. 2) Red Green Blue
  118. In order to achive more than the basical color
  119. combinations which is 8 colors, one could use
  120. other techniques of color separation as:
  121. Dithering or Rastering
  122. In the DJCDUMP.ACC I have used rastering method
  123. which will produce 4096 different colors.
  124. Since memory allocation is dynamical it really 
  125. doesn't matter which graphic card one is using!
  126.  
  127. In case you work on a monochrome display, the printout
  128. will be black on white.
  129.  
  130. So here is how to use it:
  131. Copy the DJCDUMP.ACC (or if you prefer using 
  132. TTFRACT3 rename it to TT_DUMP.ACC) to your root 
  133. directory (disk C:) and reboot your computer so 
  134. that the accessory will be active.
  135.  
  136. When you feel like printing something from
  137. the Desktop or any "GEM Program" (which is
  138. any program which uses GEM interface, 
  139. including even the MENU BAR and allowing 
  140. accessories to be called!!!!)
  141. just point your mouse and click on "DeskJet 500C
  142. HC" entry. A dialog box will open.
  143.  
  144. You will have to choice between different settings:
  145.  
  146. Resolution: 300,150,100,75 dpi (dots per inch)
  147. Depletion: None,25%,50%
  148. Shingling: None,50%,25%
  149. When: Now,10 Sec,30 Sec
  150. Orientation: Landscape,Portrait
  151. Cartridge: Colour, Monochrome
  152. Mode: Full, Top Window, Partial
  153. And exit buttons: Save-IMG,Dump,Cancel
  154.  
  155. Depletion
  156. =========
  157. Using depletion means that the printer can eliminate
  158. 25% or 50% of the printable dots. (faster draft printing)
  159.  
  160. Shingling
  161. =========
  162. Using shingling means the printer can print in an 
  163. interlaced fashion. Can increase print quality.
  164. 25% shingling will take 4 times longer to print than None.
  165.  
  166. When
  167. ====
  168. It is possible to print after a delay of 10 or 30 seconds.
  169. Allowing you to bring the screen to the situation desired
  170. for hard copy (i.e. start a program whithout accessory access).
  171. When using the delay only full screen dump and Top window are
  172. possible!
  173.  
  174. Orientation
  175. ===========
  176. One can choose between Landscape and Portrait orientation.
  177.  
  178. Mode
  179. ====
  180. Full:    If when was set to "NOW" the printout will start 
  181.          immediately.
  182. Top Window: If "when" was set to "NOW" the contents of the
  183.          active top window will be printed.
  184. Partial: After clicking on partial the dialog box will
  185.          disappear, then you can point the mouse cursor 
  186.          to the upper left corner of the area you want, 
  187.          press left mouse button and by holding it you 
  188.          can drag a box around the area you wish. 
  189.          Releasing the mouse button will start printout.
  190.  
  191. Exit Buttons
  192. ============
  193. Save-IMG: According to FULL or TOP-Window or Partial a B/W GEM
  194.           IMG file will be saved after choosing with a FileSelector
  195.           the name of that IMG file.
  196. Dump:     Printout will start.
  197. Cancel:   Will end the accessory but keeping the setup.
  198.  
  199. ***********************************************************
  200. * If you choosed a delay pressing either Full or Partial  *
  201. * or Top Window will make the dialog box disappear,       *
  202. * and after the delay period the screen will freeze and   *
  203. * printout will occur. In case of "partial" full screen   *
  204. * will be printed.                                        *
  205. ***********************************************************
  206.  
  207. DO NOT PANIC:
  208. *************
  209. You will have no control over
  210. the mouse until the screen dump has finished.
  211.  
  212. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  213. ! However one could stop printing by pressing q or ESC. !
  214. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  215.  
  216. HOT KEY
  217. *******
  218. By default holding down the keys Alternate and left shift keys
  219. and then pressing once the insert key will activate the accessory
  220. causing a printout to occour with setup depending on what is the
  221. actual setup in the accessory.
  222. However one could change this key combination using the TT_PATCH.PRG
  223. which will attempt to find the TT_DUMP.ACC in the actual drive or
  224. on drive C: of your hard disk.
  225.  
  226. Setup should be:
  227. for Paper:
  228. -----------------------------------------
  229. I            I Draft  I Normal I Best   I
  230. I Depletion  I No     I 25%    I 25%    I
  231. I Shingling  I No     I 50%    I 25%    I
  232. I Resolution I 150dpi I 300dpi I 300dpi I
  233. I Quality    I Draft  I High   I High   I
  234. -----------------------------------------
  235. Quality can be set on the printers pannel.
  236.  
  237. for Transparency:
  238. -----------------------------------------
  239. I            I Draft* I Normal I Best   I
  240. I Depletion  I        I 25%    I 25%    I
  241. I Shingling  I        I 50%    I 25%    I
  242. I Resolution I        I 300dpi I 300dpi I
  243. -----------------------------------------
  244. *Print draft on paper
  245.  
  246. ===================================================
  247. Support:
  248. TT_DUMP COMES WITH ABSOLUTELY NO WARRANTY, NOR WILL
  249. I BE LIABLE FOR ANY DAMAGES INCURRED FROM THE USE OF 
  250. IT. USE ENTIRELY AT YOUR OWN RISK!!!
  251.  
  252. I hope you will enjoy also this product and if you
  253. find TT_DUMP of value, a contribution of 30 SFr. or any 
  254. amount would be greatly appreciated as support to further 
  255. develop this or other tools.
  256. Please report any bugs.  I will TRY to fix them.
  257.  
  258. I can be reached at:
  259.     Dany Roth
  260.     Wannerstrasse 24/27
  261.     CH-8045 Zurich
  262.     Switzerland
  263.     
  264.     or on the MAUS BBS network in Grmany user DANY
  265.     (i.e ++49-89-2605293 for MAUS Munchen)
  266.     or DANY on BASI BBS in zurich ++41-1-836-4174
  267.  
  268. I hope no one charged you for any of my 
  269. previous products as: EGREP, ST_PIC,
  270. KEYBD_L, TTFRACT3, TT_DUMP2.
  271.  
  272. Please let me know if you have any comments
  273. suggestions bug-fixes... for any of my programs.
  274.  
  275.  
  276. ========================================================================
  277. Techniques:
  278. The TT_DUMP accessory can also be called from your own
  279. programms using appl_write().
  280. It must be given ID 8484 in msg_buf[5]
  281. (if you look 84=T in ascii so 8484= TT)
  282.  
  283. when it finished it will give back a AC_CLOSE message and
  284. 8484 in msg_buf[5].
  285.  
  286. i.e. one can remove menu bar and reveal a buffered screen
  287. then call the ACC and wait for evnt_mesag(msg) of AC_CLOSE
  288.  
  289. In the following example I'll demonstrate it:
  290.  
  291. ************************************************************************
  292. /* Example of how an accessory can get message from an application
  293.   and inform the application when finished */
  294.  
  295. /* from the APPLICATION side will be something like that */
  296.  
  297. void function_demo(void)
  298. {
  299.   short dump_msg[8],msg_buf[8],ap_id;
  300.  
  301.   dump_msg[4]=appl_find("TT_DUMP ");  
  302.   /* look for acc file name 8 bytes long */
  303.   if(dump_msg[4]<0)                   /* error ?? */
  304.   {
  305.     form_alert(1,"[1][Could not find TT_DUMP][OK]");
  306.     return;
  307.   }
  308.   dump_msg[0]=AC_OPEN;                /* message we send */
  309.   dump_msg[1]=ap_id;                  /* our app id */
  310.   dump_msg[2]=0;                      /* length is 16 bytes */
  311.   dump_msg[5]=8484;                   /* recogniton for TT_DUMP */
  312.   appl_write(dump_msg[4],sizeof(dump_msg),dump_msg);  /* tell the acc */
  313.   do
  314.   {
  315.     evnt_mesag(msg_buf); /* wait for the accessory to end*/
  316.   } while(msg_buf[0]!=AC_CLOSE && msg_buf[5]!=8484);  
  317.   /* we are here after the accessory has finished */
  318. }
  319. ************************************************************************
  320.  
  321. ########################################################################
  322. /* ACCESSORY part */
  323. main()
  324.   short ap_id; 
  325.   short msg[8],dump_msg[8];
  326.  
  327.   ap_id=appl_init();
  328.   menu_register(ap_id,"  Laser JetII Dump");
  329.   for (;;)                       /* endless loop dor accessory */
  330.   {
  331.     evnt_mesag(msg);                 /* wait for events */
  332.     if (msg[0]==AC_OPEN)             /* we are active */
  333.     {
  334.       dump_msg[4]=msg[1];            /* ==> callers id */
  335.       wind_update(BEG_MCTRL);
  336.       do_the_main_program();
  337.       wind_update(END_MCTRL);
  338.       if(msg[5]==8484)               /* TT in ascii */
  339.       {
  340.         dump_msg[0]=AC_CLOSE;        /* say that we finished */
  341.         dump_msg[1]=ap_id;           /* acc id */
  342.         dump_msg[2]=0;               /* no length above 16 bytes */
  343.         dump_msg[5]=8484;            /* recognition TT */
  344.         appl_write(dump_msg[4],sizeof(dump_msg),dump_msg); /* say bye */
  345.       }
  346.     }
  347.   }
  348. }
  349. ########################################################################
  350.